home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / gus / gail3213.zip / README < prev   
Text File  |  1994-01-28  |  8KB  |  208 lines
  1.  
  2.                                          A d v a n c e d
  3.                   ▄▄▄▄  ▄▄▄▄▄    ▄▄▄▄  ▄▄    ▄▄ ▄  ▄▄▄▄▄
  4.                  ▐  ▄▄  ▐    ▌  ▐█  █▌ ▐█    █▌ █ ▐▄▄▄▄▄
  5.                  ▐    ▌ ▐▀▀█▀  ▐█    █▌ ▐█  █▌  █       ▌
  6.                   ▀▀▀▀  ▀   ▀  ▀      ▀  ▀▀▀▀   ▀  ▀▀▀▀▀
  7.                  Advanced Gravis Computer Technology Ltd.
  8. 
  9.      Fax (604) 431-5155                   BBS  (604) 431-5927 V32bis
  10.      Compuserve: GO PCVENB (71333,350)    InterNET EMail: tech@gravis.com
  11.      FidoNET: 1:153/978                   SBCNET: 13:900/3
  12.      AOL: Adv Gravis                      Genie: Page M805 Topic 6
  13.  
  14.                ULTRASOUND 32 BIT AIL DRIVERS - 01/29/94
  15.  
  16.  
  17.                    1.0 What are these drivers?
  18.                    2.0 How to 'back patch' games.
  19.                    3.0 Developer information
  20.  
  21.  
  22. 1.0.0 ************* CHAPTER 1. - WHAT ARE THESE DRIVERS? *****************
  23.  
  24. This package contains 'IBM Audio Interface Library for 32-bit DOS' (AIL/32)
  25. drivers for the Gravis UltraSound card. This allows developers who use
  26. AIL/32 in their products to easily add native UltraSound support. It also
  27. allows end users to easily 'back patch' products which have shipped without
  28. UltraSound drivers (in effect adding native UltraSound support to games
  29. which have shipped without it).
  30.  
  31. Developers should proceed to chapter 3 and read the information there.
  32.  
  33. Other users should read on. Advanced users may find the developer of some
  34. interest.
  35.  
  36. Some products which use AIL/32 and can be back patched with these drivers
  37. are:
  38.  
  39. Indycar Racing
  40. Shadow Caster
  41. Sim City 2000
  42. SVGA Air Warrior
  43. Syndicate
  44.  
  45. 4.0.0 ************ CHAPTER 4. - HOW TO 'BACK PATCH' GAMES ****************
  46.  
  47. 1.  After installing your game, back up all of the games sound drivers. The
  48.     drivers ususally have the extension .DLL.
  49.  
  50. 2.  Copy the files LOADPATS.EXE and PATCHES.INI into the directory the game
  51.     is installed in.
  52.  
  53. 3.  Copy GUSMID32.DLL over one of the games music drivers (preferably
  54.     a General MIDI driver). The most common names for the music drivers
  55.     are:
  56.  
  57.     A32MT32.DLL    - MT-32/General MIDI driver
  58.     A32SPKR.DLL    - PC Speaker Music driver
  59.     A32ADLIB.DLL   - AdLib Music Driver
  60.     A32ALGFM.DLL   - AdLib Gold Music Driver
  61.     A32SBFM.DLL    - Sound Blaster Music Driver
  62.     A32SP1FM.DLL   - Sound Blaster Pro 1 Music Driver
  63.     A32SP2FM.DLL   - Sound Blaster Pro 2 Music Driver
  64.     A32PASFM.DLL   - Pro Audio Spectrum Music Driver
  65.     A32PASOP.DLL   - Pro Audio Spectrum (OPL3) Music Driver
  66.     A32MT32S.DLL   - MT-32/General MIDI driver (SB MIDI interface)
  67.     A32ARXM.DLL    - ARIA Music Driver
  68.  
  69. 4.  Copy GUSDIG32.DLL over one of the games digital drivers. The most
  70.     common names for the digital drivers are:
  71.  
  72.     A32SBDG.DLL    - Sound Blaster Digital Driver
  73.     A32SBPDG.DLL   - Sound Blaster Pro Digital Driver
  74.     A32PASDG.DLL   - Pro Audio Spectrum Digital Driver
  75.     A32ALGDG.DLL   - AdLib Gold Digital Driver
  76.     A32ARDG.DLL    - ARIA Digital Driver
  77.  
  78. NOTE: The batch file COPYDRVS.BAT provided in this package is designed to
  79.     perform steps 1 to 4 for you automatically PROVIDED the drivers use
  80.     the standard names listed above, or, you are patching Syndicate. In
  81.     particular the game must have one of the following file names:
  82.  
  83.     A32MT32.DLL
  84.     A32SBFM.DLL
  85.     A32SBDG.DLL
  86.  
  87.     To use COPYDRVS type:
  88.  
  89.     COPYDRVS dir_name <ENTER>
  90.  
  91.     where dir_name is the directory where the games sound drivers are
  92.     installed.
  93.  
  94.     e.g.  COPYDRVS C:\INDYCAR <ENTER>
  95.       or  COPYDRVS C:\SC2000\SOUND <ENTER>
  96.       or  COPYDRVS C:\SYND\DATA <ENTER>
  97.  
  98. 5.  Run LOADPATS by typing LOADPATS <ENTER>
  99.  
  100. 6.  Run the game's setup or install software (provided it has one).
  101.     Configure the games sound to use the drivers you copied the
  102.     UltraSound drivers over.
  103.  
  104.     If you used COPYDRVS and it worked, select in the following order:
  105.  
  106.     Sound Blaster for digital, General MIDI for music.
  107.     Sound Blaster for digital, MT-32 for music.
  108.     Sound Blaster for both digital and/or music.
  109.  
  110. Now everytime you run your game:
  111.  
  112. 7.  Run LOADPATS.
  113.  
  114. 8.  Start your game.
  115.  
  116.  
  117. 3.0.0 ************** CHAPTER 3. - DEVELOPER INFORMATION ******************
  118.  
  119. These drivers are for use with the Rational DOS4GW DOS extender only.
  120. Drivers for other platforms can be made available if interest is shown.
  121.  
  122. Files of interest:
  123.  
  124. GUSDIG32.DLL is a PCM sample playback driver. It will play back most forms
  125.   of data except Sound Blaster ADPCM compressed samples.
  126.  
  127. GUSMID32.DLL is an XMIDI driver, designed to play General MIDI sequences.
  128.   By editing PATCHES.INI it can be used to play back sequences for other
  129.   synths (MT-32 sequences for example).
  130.  
  131. LOADPATS.EXE and PATCHES.INI are also required (see below).
  132.  
  133. There are several differences between these drivers and 32 bit AIL drivers
  134. for other cards.
  135.  
  136. * LOADPATS.EXE must be run before either of the drivers will work. This is
  137.   easily accomplished by using a batch file to load your product and
  138.   calling LOADPATS at the start of this batch file. If LOADPATS fails it
  139.   will return a DOS errorlevel of 1, otherwise it returns a 0. You can use
  140.   this to exit from the batch file on an error. The following is an example
  141.   batch file:
  142.  
  143.     @echo off
  144.     loadpats
  145.     if errorlevel 1 goto end
  146.     rungame
  147.     :end
  148.  
  149.   LOADPATS loads patches onto the UltraSound DRAM and sets up several
  150.   parameters on the UltraSound card required for the AIL drivers to
  151.   operate. It is NOT a TSR. Do not run another UltraSound application
  152.   between running LOADPATS and your product.
  153.  
  154. * The drivers ignore hardware parameters passed by AIL_detect_device and
  155.   AIL_init_driver. The hardware parameters are taken from the ULTRASND
  156.   environment variable when LOADPATS is run.
  157.  
  158. * AIL_detect_device will check to make sure LOADPATS has been run.
  159.   However it will not check to see if the hardware irq or DMA settings are
  160.   in conflict with another device. This should not be a problem since the
  161.   ULTRASND environment variable is used for most UltraSound software, and
  162.   hence must be correct for the UltraSound to operate.
  163.  
  164. * The UltraSound drivers WILL work properly with hardware irq's higher than
  165.   7. Other drivers will not due to limitations of the DOS4GW extender.
  166.  
  167. -----------------------------------------------------------------------------
  168. INFORMATION ON LOADPATS:
  169.  
  170. LOADPATS is a simple program which loads the MIDI patches and information
  171. on how to play them onto the UltraSound card. Running LOADPATS gives a
  172. similar functionality as having ROM samples. The patches loaded are
  173. specified in PATCHES.INI, and are loaded in the order specified, until
  174. the UltraSound on board memory is full. Listing only the patches used in
  175. your sequences will result in optimum performance. See the header in
  176. PATCHES.INI for more information on creating a custom .INI file.
  177.  
  178. Command line options:
  179.  
  180. -H -?  Display a help screen.
  181. -16    Load patches at 16 bit instead of 8 bit. This can be usefull if you
  182.        use a custion .INI file which lists only a few patches.
  183. -Mxxx  Set music master volume (relative to digital volume). xxx=1 to 100.
  184.        xxx=90 is the default.
  185. -Iname Specify a different .INI file (instead of PATCHES.INI). 'name' can
  186.        just be a file name, or a complete DOS pathname.
  187. -Q     Disables the screen output.
  188.  
  189. 4.0.0 ***************** CHAPTER 4. - REVISION HISTORY ********************
  190.  
  191. 94/01/20  Corrected a bug in proccessing of text files. This would
  192.           cause LOADPATS to lock up with certain .INI files.
  193.  
  194. 94/01/21  Pressing Ctrl-C while running LOADPATS will no longer leave the
  195.           system unstable (irq's were not getting unhooked).
  196.  
  197.           AIL_detect_device will now use the ULTRASND environment variable
  198.           to get the UltraSound base address. Previously it would probe
  199.           for the base address, causing problems with other hardware
  200.           devices.
  201.  
  202.           Improved documentation.
  203.  
  204. 94/01/25  Drivers are now backward compatible with the older DLLLOAD.C, and
  205.           hence can be used in place of A32MT32.DLL and A32SBDG.DLL etc.
  206.  
  207.                             END OF README
  208.